package com.bookstore.back.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.bookstore.back.entity.Order;
import com.bookstore.back.vo.OrderVO;

import java.util.List;
import java.util.Map;

/**
 * 订单服务接口
 * 
 * @author 程序猿_Ti
 * @since 2025-07-19
 */
public interface OrderService extends IService<Order> {

    /**
     * 分页查询订单列表
     *
     * @param params 查询参数
     * @return 分页结果
     */
    IPage<Order> getOrderList(Map<String, Object> params);

    /**
     * 分页查询订单列表（包含用户信息）
     *
     * @param params 查询参数
     * @return 分页结果
     */
    IPage<OrderVO> getOrderListWithUserInfo(Map<String, Object> params);

    /**
     * 获取订单详情
     *
     * @param orderId 订单ID
     * @return 订单详情
     */
    Map<String, Object> getOrderDetail(Integer orderId);

    /**
     * 获取订单详情（包含用户和作者信息）
     *
     * @param orderId 订单ID
     * @return 订单详情
     */
    Map<String, Object> getOrderDetailWithInfo(Integer orderId);

    /**
     * 更新订单状态
     * 
     * @param orderId 订单ID
     * @param status 状态
     * @return 是否成功
     */
    boolean updateOrderStatus(Integer orderId, Integer status);

    /**
     * 发货处理
     * 
     * @param orderId 订单ID
     * @return 是否成功
     */
    boolean shipOrder(Integer orderId);

    /**
     * 取消订单
     * 
     * @param orderId 订单ID
     * @param reason 取消原因
     * @return 是否成功
     */
    boolean cancelOrder(Integer orderId, String reason);

    /**
     * 获取最近订单
     * 
     * @param limit 数量限制
     * @return 最近订单列表
     */
    List<Order> getRecentOrders(Integer limit);

    /**
     * 获取订单统计数据
     * 
     * @return 统计数据
     */
    Map<String, Object> getOrderStats();

}
